Miêu tả tham số Bản_mẫu:Hộp_điều_hướng

Dưới đây là danh sách đầy đủ các tham số của {{Navbox}}. Trong phần lớn trường hợp, những tham số bắt buộc chỉ là tên, tiêu đề, và dsach1, mặc dù các navbox con thậm chí không cần thiết lập chúng.

{{Navbox}} dùng chung nhiều tên tham số như các bản mẫu anh em với nó {{Navbox with columns}} và {{Navbox with collapsible groups}} để thống nhất và dễ sử dụng. Các tham số được đánh dấu bằng một dấu sao (*) là dùng chung cho cả 3 bản mẫu này.

Các tham số thiết lập

name / tên*Tên của bản mẫu, cần thiết cho các liên kết "X • T • S" ("xem • thảo luận • sửa") hoạt động đúng tại tất cả các trang có sử dụng bản mẫu. Bạn có thể gõ {{subst:PAGENAME}} để tạo nhanh giá trị này. Tham số tên chỉ bắt buộc nếu có tham số tiêu đề, và tham số khung không được thiết lập.state / trạng thái* [autocollapse, uncollapsed, collapsed, plain, off]
  • Mặc định là autocollapse. Một navbox với autocollapse sẽ bắt đầu bằng đóng nếu có hai hoặc nhiều bảng trong cùng một trang có sử dụng bảng đóng mở. Nếu không, navbox sẽ được mở. Để có thông tin về kỹ thuật mời xem MediaWiki:Common.js.
  • Nếu thiết lập là collapsed, navbox sẽ luôn bắt đầu trong trạng thái đóng.
  • Nếu thiết lập là plain, navbox sẽ luôn luôn mở mà không có liên kết [ẩn] bên phải, và tiêu đề sẽ nằm ở giữa (bằng cách dùng padding để cân bằng với liên kết X • T • S).
  • Nếu thiết lập là off, navbox sẽ luôn mở mà không có liên kết [ẩn] ở phía phải, nhưng không sử dụng padding để giữ tiêu đề vào giữa. Cách này chỉ dùng cho người nào biết rõ; tùy chọn "plain" là đủ cho đa số ứng dụng trong đó cần giấu đi nút [ẩn]/[hiện].
  • Nếu thiết lập thứ khác ngoài autocollapse, collapsed, plain, hay off (như "uncollapsed"), navbox sẽ bắt đầu ở trạng thái mở, và có nút "ẩn".
Để hiện hộp khi đứng một mình (không nhúng) nhưng khi đó nội dung tự động ẩn khi trong bài, hãy đặt "uncollapsed" bên trong thẻ <noinclude>:
  • trạng thái = <noinclude>uncollapsed</noinclude>
  • Các thiết lập đó sẽ buộc hộp hiển thị khi đứng một mình (thậm chí khi có hộp khác theo sau), hiển thị "[ẩn]" nhưng vẫn tự động đóng khi chèn vào bài.
Thông thường, biên tập viên sẽ muốn một trạng thái khởi đầu mặc định đối với navbox, có thể thay đổi trong bài viết. Đây là mẹo để làm chuyện đó:
  • Trong bản mẫu trung gian của bạn, tạo một tham số cũng có tên "trạng thái" để vượt qua như sau:
  • | trạng thái = {{{trạng thái<includeonly>|trạng thái mong muốn</includeonly>}}}
  • <includeonly>| sẽ khiến bản mẫu mở khi xem chính trang bản mẫu.
navbar / thanh chuyển hướng*Mặc định là dùng Tnavbar. Nếu thiết lập là plain, các liên kết X • T • S ở phía trái ở thanh tiêu đề sẽ không hiển thị, và padding sẽ tự động được dùng để giữa cho tiêu đề nằm giữa. Dùng off để bỏ liên kết X • T • S, nhưng không áp dụng padding (chỉ dùng khi hiểu rõ; tùy chọn "plain" là đủ cho hầu hết ứng dụng khi không cần một navbar). Chú ý rằng bạn được khuyến cáo không ẩn navbar, để người dùng dễ sửa đổi bản mẫu, và để giữa một kiểu tiêu chuẩn cho tất cả các trang.border / khung*Xem mục dưới để sử dụng navbox bên trong một navbox khác với ví dụ và miêu tả đầy đủ hơn. Nếu thiết lập là con hay nhóm con, thì navbox có thể được dùng như một hộp con không có khung bao quanh nằm gọn trong navbox khác. Khung được ẩn và không có padding ở hai bên bảng, do đó nó vừa vào khu vực danh sách của navbox cha. Nếu thiết lập là none, thì khung sẽ ẩn và padding bị bỏ đi, navbox có thể được dùng như con của một navbox chứa khác (đừng sử dụng tùy chọn none bên trong một navbox khác; tương tự như vậy, chỉ dùng tùy chọn con/nhóm con bên trong navbox khác). Nếu thiết lập bất kỳ giá trị nào khác (mặc định), thì một navbox bình thường hiển thị với khung dày 1px. Một cách thay thế để xác định khung là một kiểu cho nhóm như thế này (tức là sử dụng tham số đầu tiên không tên thay vì tham số khung có tên):{{Hộp điều hướng|con...}}

Ô bên trong

title / tiêu đề*Văn bản hiện ra ở giữa tại hàng đầu tiên của bảng. Nó thường là chủ đề của bản mẫu, tức là một miêu tả cô đọng về nội dung của hộp. Cái này chỉ nên có một dòng, nhưng nếu cần dòng thứ hai, hãy dùng {{Clear}} để đảm bảo canh dòng cho đúng. Tham số này về kỹ thuật là không bắt buộc, nhưng sử dụng {{Navbox}} mà không có tiêu đề thì rất vô ích.groupn / nhómn(tức, nhóm1, nhóm2, v.v.) Nếu chỉ định, văn bản hiển thị trong ô tiêu đề đặt ở phía tranh dsachn. Nếu bỏ đi, dsachn sử dụng toàn bộ chiều rộng bảng.listn / dsachn*(tức, dsach1, dsach2, v.v.) Thân bản mẫu, thường là danh sách các liên kết. Định dạng là nằm liên tục, mặc dù văn bản có thể được gõ theo từng dòng riêng biệt nếu toàn bộ danh sách được đặt trong <div> </div>. Ít nhất phải có một tham số dsach; mỗi dsach thêm vào được hiển thị trong một hàng tách biệt của bảng. Mỗi dsachn có thể được một tham số nhómn đứng trước, nếu cần (xem ở dưới).image / hình*Có thể hiển thị hình trong một ô phía dưới tiêu đề và bên phải nội dung (nhóm/dsach). Để hình hiển thị đúng, tham số dsach1 phải được ghi. Tham số hình chấp nhận mã wiki chuẩn để hiển thị hình, tức làhình = [[Hình:Example.jpg|100px]]imageleft / hình trái*Để hiển thị hình trong một ô phía dưới tiêu đề và phía trái nội dung (dsach). Để hình hiển thị đúng, tham số dsach1 phải được ghi và không có nhóm nào. Tham số hình trái chấp nhận mã wiki chuẩn để hiển thị hình, tức làhình trái = [[Hình:Example.jpg|100px]]above / trên*Một ô dài đầy đủ hiển thị giữa thanh tiêu đề và nhóm/dsach đầu tiên, tức là trên nội dung bản mẫu (nhóm, danh sách và hình). Trong một bản mẫu không có hình, trên hoạt động giống như tham số dsach1 mà không có tham số nhóm1.below / dưới*Một ô dài đầy đủ hiển thị dưới nội dung bản mẫu (nhóm, danh sách và hình). Trong một bản mẫu không có hình, dưới hoạt động giống như tham số dsachn cuối cùng của bản mẫu mà không có tham số nhómn.

Tham số tạo kiểu

Tạo kiểu nói chung không khuyến khích để giữ sự thống nhất giữa các bản mẫu và trang tại Wikipedia. Tuy nhiên, vẫn có tùy chọn để điều chỉnh kiểu.

bodystyle / kiểu thân*Xác định kiểu CSS để áp dụng cho thân bản mẫu. Tùy chọn này nên được dùng cẩn trọng vì nó có thể dẫn tới không thống nhất khi hiển thị. Ví dụ:style = background:#nnnnnn;style = width:N [em/%/px or width:auto];style = float:[left/right/none];style = clear:[right/left/both/none];basestyle / kiểu gốc*Kiểu CSS áp dụng cho các ô tiêu đề, trên, dưới, và nhóm. Kiểu này không áp dụng cho các ô danh sách. Nó thuận tiện để đổi màu cơ bản của navbox mà không phải lặp lại việc chỉ định kiểu cho từng phần khác nhau của navbox. Ví dụ:basestyle = background:lightskyblue;titlestyle / kiểu tiêu đề*Kiểu CSS áp dụng cho tiêu đề, thông dụng nhất là màu nền cho thanh tiêu đề:titlestyle = background:#nnnnnn;titlestyle = background:name;groupstyle / kiểu nhómKiểu CSS áp dụng cho các ô nhómN cells. Tùy chọn này ghi đè bất kỳ kiểu nào áp dụng cho toàn bảng. Ví dụ:groupstyle = background:#nnnnnn;groupstyle = text-align:[left/center/right];groupstyle = vertical-align:[top/middle/bottom];groupnstyle / kiểu nhóm nKiểu CSS áp dụng cho một nhóm cụ thể, ngoài bất kỳ kiểu nào xác định bởi tham số groupstyle. Tham số này chỉ nên dùng khi thật cần thiết để bảo đảm chuẩn hóa và đơn giản hóa. Ví dụ:group3style = background:red;color:white;groupwidth / chiều rộng nhómMột con số đi kèm đơn vị để quy định chiều rộng của nhóm, dùng trong những trường hợp ô nhóm quá rộng vì có chứa văn bản dài. Tuy nhiên tham số này có thể bị tham số group(n)style ghi đè. Ví dụ:groupwidth = 9emliststyle / kiểu danh sách*Danh sách CSS để áp dụng cho tất cả các danh sách. Sẽ bị ghi đè bởi tham số oddstyle và evenstyle (nếu có) ở dưới.listnstyle / kiểu danh sách n*Kiểu CSS áp dụng cho một nhóm cụ thể, ngoài bất kỳ kiểu nào chỉ định bởi tham số groupstyle. Tham số này chỉ nên dùng khi thật cần thiết để giữ chuẩn hóa và đơn giản hóa. Ví dụ:list5style = background:#ddddff;listpadding*Số và đơn vị dùng để chỉ định padding trong mỗi ô dsach. Các ô dsach đi kèm với một padding mặc định là 0.25em về trái và phải, và 0em ở trên và dưới. Do lý do kỹ thuật phức tạp, nếu chỉ đơn giản ghi "liststyle=padding:0.5em;" (hoặc bất kỳ thiết lập padding nào khác) sẽ không hoạt động. Ví dụ:listpadding = 0.5em 0em; (thiết lập padding 0.5em cho trái/phải, và 03m cho trên/dưới.)listpadding = 0em; (bỏ tất cả các padding.)oddstyle / kiểu lẻevenstyle / kiểu chẵnÁp dụng số danh sách chẵn/lẻ. Kiểu ghi đè được định nghĩa bởi liststyle. Cách hiển thị mặc định là thêm màu xen kẽ (trắng và xám) vào các hàng lẻ/chẵn, để tăng tính dễ đọc. Những tham số này không nên thay đổi trừ khi trong tình huống dị thường.evenodd / chẵn lẻ [swap, even, odd, off]Nếu thiết lập là swap, sự xen kẽ hàng chẵn và lẻ tự động đảo ngược. Thông thường, hàng chẵn có nền xám nhẹ; khi tham số này được dùng, hàng lẻ sẽ có màu xám nhẹ thay cho hàng chẵn. Thiết lập là even hay odd sẽ thiết lập tất cả các hàng có màu xen đó. Thiết lập off tắt tự động tô màu hàng. Tham số nâng cao này chỉ nên dùng để sửa các vấn đề khi navbox được dùng làm con của một navbox khác và đường gạch ngang không phù hợp. Các ví dụ và mô tả kỹ hơn có thể tìm thấy ở phần navbox con bên dưới.abovestyle / kiểu trên*belowstyle / kiểu dưới*Kiểu CSS áp dụng vào ô trên cùng (xác định bằng tham số trên) và ô dưới cùng (xác định bằng tham số dưới). Thường được dùng để thiết lập màu nền hoặc canh dòng:abovestyle = background:#nnnnnn;abovestyle = text-align:[left/center/right];imagestyle / kiểu hình*imageleftstyle / kiểu hình trái*Kiểu CSS áp dụng cho các ô trong đó có hình/hình trái. Những kiểu này chỉ nên dùng trong các tình huống ngoại lệ, thường để sửa vấn đề về chiều rộng nếu chiều rộng của nhóm được thiết lập và chiều rộng của ô hình trở nên quá lớn. Ví dụ:imagestyle = width:5em;
Các kiểu mặc định

Các thiết lập kiểu dưới đây là những kiểu mà các biên tập viên dùng navbox thay đổi nhiều nhất. Các kiểu thiết lập phức tạp hơn không có trong danh sách này để giữ cho nó đơn giản. Đa số kiểu được thiết lập trong MediaWiki:Common.css.

bodystyle = background:#fdfdfd; width:100%; vertical-align:middle;titlestyle = background:#ccccff; padding-left:1em; padding-right:1em; text-align:center;abovestyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;belowstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;groupstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:right;liststyle  = background:transparent; text-align:left/center;oddstyle = background:transparent;evenstyle  = background:#f7f7f7;

Vì liststyle và oddstyle là danh sách lẻ trong suốt có màu với bodystyle, mặc định là #fdfdfd (trắng với một chút xám). Một danh sách có text-align:left; nếu nó có nhóm, nếu không nó sẽ là text-align:center;. Vì chỉ có bodystyle có một dóng thẳng đứng, tất cả cái khác thừa kế vertical-align:middle; của nó.

Tham số nâng cao

bodyclass / lớp thânaboveclass / lớp trêngroupclass / lớp nhómlistclass / lớp danh sáchbelowclass / lớp dướiGán lớp cho thân, trên, nhóm, danh sách, dưới. Cách dùng thường gặp nhất là đặt cho các tham số này giá trị hlist để giúp một danh sách hoa thị hiển thị ngang. Có thể dùng tham số |bodyclass = hlist trong trường hợp cần gán lớp hlist cùng lúc cho hai (hoặc nhiều hơn) trong số các tham số kể trên.titlegroup / tiêu đề nhómCái này đặt một nhóm vào khu vực tiêu đề, với cùng kiểu mặc định như nhómn. Nó chỉ nên được dùng trong tình huống ngoại lệ (thường là siêu bản mẫu nâng cao) và việc sử dụng nó cần một ít kiến thức về mã bên trong {{Navbox}}; bạn nên sẵn sàng cho việc thiết lập bằng tay kiểu CSS để khiến mọi thức hoạt động đúng nếu bạn muốn dùng nó. Nếu bạn cho rằng bạn có một ứng dụng cho tham số này, có thể cần phải thay đổi suy nghĩ, hoặc hỏi tại trang thảo luận cái đã.titlegroupstyle / kiểu tiêu đề nhómKiểu dành cho ô nhóm tiêu đề.innerstyle / kiểu trongMột tham số cực kỳ nâng cao chỉ dùng cho các siêu bản mẫu nâng cao có dùng navbox. Navbox có cấu trúc thật sự như sau: navbox sử dụng một bảng ngoài để vẽ khung, và một bảng trong dành cho mọi thứ khác (tiêu đề/trên/nhóm/dsach/dưới/hình, v.v.). Tham số style/bodystyle thiết lập kiểu cho bảng ngoài, bảng trong sẽ thừa kế nó, nhưng trong những trường hợp cao cấp (siêu bản mẫu) có thể cần phải thiết lập trực tiếp cho bảng trong. Tham số này cung cấp cách tiếp cận cho bảng trong đó để ứng dụng kiểu. Hãy dùng một cách cẩn trọng.